# Troubleshooting

To add new solutions, please open a pull request, issue or contact me directly.


**Game does not start at all**

1. Check & update the game version in your launcher
2. Apply the correct modifications


**StartThreadpoolIo not found in KERNEL32.dll**

 * Use Wine 5.3 or newer. This function has been added recently.


**Graphics bugs/issues**

 * Check whether your GPU supports Vulkan:
     * [inofficial list](https://vulkan.gpuinfo.org/), [Intel](https://www.intel.com/content/www/us/en/support/articles/000005524/graphics.html), [nVIDIA](https://developer.nvidia.com/vulkan-driver), [AMD](https://www.amd.com/en/technologies/vulkan#paragraph-218601)
     * If yes -> download [winetricks](https://github.com/Winetricks/winetricks/)
     * Install the DLL package `dxvk` (stable version)
 * Launch the game using proton
 * Try wine 5.19-staging (or newer)


**Mouse/keyboard input issues**

1. winecfg -> capture mouse in full screen
2. regedit -> `HKEY_CURRENT_USER\Software\Wine\X11 Driver` set REG_SZ `UseTakeFocus` to `N`
      * Lutris already does this by default.


**Switching between workspaces causes the view to "spin"**

 * Open the ESC/Paimon menu, move the mouse and close it again
 * Run the game in a non-fullscreen virtual desktop
     * `wine explorer /desktop=anyname,1600x900 cmd /k launcher.bat`
 * Change the in-game resolution setting
     * Focus the (virtual) desktop
     * Focus the game window again
     * Change the resolution back to fullscreen


**Weak graphics, slow game**

Please keep in mind that the minimal specifications also apply for Linux. Do not expect a performance gain compared to Windows native.

1. Change the detail level to `1.0` other values may be slower
2. Lower the resolution. Edit `launcher.bat` and append following arguments:
     * `-screen-width XXX -screen-height YYY -screen-fullscreen 1`
     * or change the virtual desktop's size (if present)
3. See also: [Unity CLI args](https://docs.unity3d.com/Manual/CommandLineArguments.html)
     * `-screen-quality` is only applied to the first login scene, hence useless


**err:virtual:virtual_setup_exception stack overflow**

First seen after a server update on 24/25 Dec.

	bash /path/to/GI-on-Linux/GAMEVER/patch_anti_logincrash.sh

For more details, see https://notabug.org/Krock/GI-on-Linux/issues/23 .


### Information sources

General information:

 * [PlayOnLinux](https://www.playonlinux.com/en/app-4228.html)

StartThreadpoolIo error:

 * [Issue#12](https://notabug.org/Krock/GI-on-Linux/issues/12#issuecomment-22060)